home *** CD-ROM | disk | FTP | other *** search
/ Power DOS 1996 July / Power DOS - July 1996.iso / sound / c_labs / misc / macvoc.exe / UNSIT.DOC < prev    next >
Text File  |  1988-03-01  |  4KB  |  95 lines
  1.  
  2.             UNSIT -- StuffIt Achive File Disassembler
  3.             -----------------------------------------
  4.  
  5. VERSION 2.0    26 Feb 1988
  6.      UNSIT 2.0 now has an option to add a MacBinary header.   Some DOS 
  7. program  require this header for proper operation.   An extracted file 
  8. with  the MacBinary header should now exactly match the file  uploaded 
  9. directly  from a Mac.   A MacBinary header is added to Mac files  when 
  10. they are transmitted by almost all Mac terminal programs.   The header 
  11. contains  information from the Mac directory entry for that file  such 
  12. as file name, file type, and attribute flags.  
  13.  
  14.      A  Mac file with a MacBinary header contain a resource fork and a 
  15. data  fork,  either of which may be empty.   Some DOS programs do  not 
  16. work  correctly if the Mac file contains a non-empty resource fork  so 
  17. there  is an option to extract just the data fork even if  both  forks 
  18. are  present  in the SIT file.   It is also possible to  extract  both 
  19. forks into a single file.
  20.  
  21.      No new option flags have been added.  You will have the option to 
  22. put  a MacBinary header or not when extracting each file.   This makes 
  23. it  easier to extract a binary data file with a header then extract  a 
  24. text  file  without  a header in one pass through  the  Stuffit  file.  
  25.  
  26.  
  27. INTRODUCTION:
  28.      UNSIT  is a simple utility for PC users to extract files  from  a 
  29. StuffIt file.  StuffIt files usually appear with the ".SIT" extension.  
  30.  
  31.      StuffIt  is  a  program  for Macs similar to  ARC  for  PCs.   It 
  32. collects  several files in a single file and also compresses the  data 
  33. using run length, Huffman, or LZW compression.  StuffIt is emerging as 
  34. THE archive program for the Mac.   Unfortunately,  this means new  Mac 
  35. files  are  frequently  inaccessible they are now  "stuffed"  to  save 
  36. transmission costs and disk space.  
  37.  
  38.      Most  Mac files are not very useful on a PC but MacPaint  picture 
  39. files are an exception.   There are several programs including READMAC 
  40. and  ALLMAC that can display and print MacPaint files on a  PC.   Once 
  41. displayed, some PC paint programs can capture the image from video RAM 
  42. into  a  file appropriate for that program for  further  manipulation.  
  43. Other  programs  such  as MactoWin and MacShow  can  directly  convert 
  44. MacPaint files to Microsoft Windows Paint format.
  45.  
  46.      UNSIT  does not handle PackIt archive files which usually  appear 
  47. with the ".PIT" extension.  An extract-only utility called UnPackIt is 
  48. available on the PC.
  49.  
  50. VERSION:
  51.      UNSIT Version 1.1
  52.  
  53.  
  54. PURPOSE:
  55.      List  files in and extract files from a StuffIt archive file on a 
  56. PC.  
  57.  
  58.  
  59. COMMAND OPTIONS:
  60.      unsit [l|v|x|e|xb|eb] StuffItFile[.SIT]
  61.  
  62.      l, v = list directory of files
  63.      x, e  = extract all files with CR to CR LF translation  on  text 
  64.                files
  65.      xb, eb = extract all files with no translation
  66.  
  67.  
  68.      Mac  files  come with in two parts,  the resource fork  and  data 
  69. fork.   I  have not found any use on the PC for the resource fork  but 
  70. UNSIT will extract it anyway.
  71.  
  72.      The  normal  EXTRACT  options,  'x' or  'e',  will  automatically 
  73. convert Mac text files to PC text files.   The only difference appears 
  74. to  be Mac text file lines end with only a carriage return (CR)  while 
  75. PC text file lines end with carriage return (CR) and line feed (LF).  
  76.  
  77.      If  the translation causes any problems,  use the EXTRACT  BINARY 
  78. options, 'xb' or 'eb', which never do any translation.  Non-text files 
  79. are always extracted with NO translation.  
  80.  
  81.  
  82. NOTICES:
  83.      Copyright  (c) 1988,  Brian K.  Uechi.   Portions of this program 
  84. written and copyrighted by Raymond Lau.   You may copy and  distribute 
  85. this  program  freely,  provided  that it is distributed ONLY  in  its 
  86. original, unmodified state.
  87.  
  88.      DISCLAIMER:   No warranty of any kind is made with regard to this 
  89. program.   The Authors shall be not liable for errors contained herein 
  90. or  for  incidental  or  consequential  damages  in  connection   with 
  91. furnishing, performance, or use of this material.
  92.  
  93. Brian K. Uechi
  94. GEnie:  B.UECHI
  95. CompuServe:  72330,155